Skip to content

feat(toolpath): add meta.kind path-kind field; tag conversation paths "convo"#85

Open
ben-emp wants to merge 2 commits into
mainfrom
ben/kind-metadata-field
Open

feat(toolpath): add meta.kind path-kind field; tag conversation paths "convo"#85
ben-emp wants to merge 2 commits into
mainfrom
ben/kind-metadata-field

Conversation

@ben-emp
Copy link
Copy Markdown
Collaborator

@ben-emp ben-emp commented May 12, 2026

Adds an optional meta.kind field to Path (PathMeta::kind + a PATH_KIND_CONVERSATION constant), so renderers and parsers can recognize a path’s shape. Plumbed through the JSONL form alongside title/source.

The one defined value is "convo", and every conversation → Path derivation now sets it (the shared toolpath_convo::derive_path and each conversation provider crate). Documented in the RFC ("Document Kind") and the JSON Schema. Additive — existing documents parse and validate unchanged. No version bumps yet.


View in Codesmith
Need help on this PR? Tag @codesmith with what you need.

  • Let Codesmith autofix CI failures and bot reviews

… "convo"

New optional `meta.kind` on `Path` (`PathMeta::kind` + the
`PATH_KIND_CONVERSATION` constant), plumbed through the JSONL form. Every
conversation -> Path derivation now sets `meta.kind = "convo"` — the shared
`toolpath_convo::derive_path` and each conversation provider crate's own.
Documented in the RFC ("Document Kind") and the JSON Schema. Additive; no
version bumps yet.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 12, 2026

🔍 Preview deployed: https://fbc2d7d0.toolpath.pages.dev

Copy link
Copy Markdown
Contributor

@akesling akesling left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update the enum value name and then LGTM. We may also want a kind version and need to follow up with a specification as to what fields go where and why to reflect what we're doing in our transformations and help Claude stay aligned (e.g. we should be able to point Claude at this format spec and have it find bugs, fix things, not paint too much outside the lines).

Comment thread RFC.md Outdated
unrecognized `kind` should be treated as a generic path. The only value defined
so far is **`convo`** (future revisions may register more).

A **`convo`** path is an AI coding conversation. Each conversational-turn step
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's call this an "agent-session" or "agent-coding-session" or something that's a bit more self-descriptive. Update the enum name, etc. as well.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good call

Renames the kind value `"convo"` to `"agent-coding-session"` and the
constant `PATH_KIND_CONVERSATION` to `PATH_KIND_AGENT_CODING_SESSION`.
Updates schema, RFC, CHANGELOG, CLAUDE.md, and all derive crates + tests.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants